home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / upchk71f.zip / UPCHECK.DOC < prev    next >
Text File  |  1997-07-26  |  37KB  |  792 lines

  1.  
  2.  
  3.            ▄ ▄ ▄▄▄ ▄▄▄ ▄ ▄ ▄▄▄ ▄▄▄ ▄ ▄
  4.            █ █ █▄█ █   █▄█ █▄  █   █▄▀  The Premium Upload Scanner
  5.            █▄█ █   █▄▄ █ █ █▄▄ █▄▄ █ █         Version 7.1f
  6.  
  7.        Copyrighted Peter Rocca & Multiboard Communications, 1994-1997
  8.                               All rights reserved
  9.  
  10.  
  11. ╓───────────────────────────────────────────────────────────────────────────╖
  12. ║ What is it?                                                               ║
  13. ╙───────────────────────────────────────────────────────────────────────────╜
  14.  
  15.     A premium upload scanner, description handler and true duplicate CRC
  16.     detection built in.  Also can write a message to the user, explaining
  17.     why the file failed, and/or to the Sysop with a warning or message
  18.     receipt.  Fast and easy to use!
  19.  
  20.  
  21. ╓───────────────────────────────────────────────────────────────────────────╖
  22. ║ Quick Note                                                                ║
  23. ╙───────────────────────────────────────────────────────────────────────────╜
  24.  
  25.     Although the docs aren't the shortest ones, I suggest  you at least
  26.     skim through them in order to get your system set up correctly... If
  27.     you are confident that you can set up the program then run UPSETUP
  28.     and you can also use the F1 key from that program for online help.
  29.  
  30.  
  31. ╓───────────────────────────────────────────────────────────────────────────╖
  32. ║ Overview                                                                  ║
  33. ╙───────────────────────────────────────────────────────────────────────────╜
  34.  
  35.     UpCheck and it's companion utilities are more than any Sysop could
  36.     require in an upload file processing system...
  37.  
  38.     UpCheck is a small and quick program that is capable of scanning an
  39.     upload for file integrity, duplications, as well as being able to
  40.     remove unwanted files, add files and then recompress the archive in
  41.     maximum compression mode.
  42.  
  43.     You also have the ability to quickly insert the FILE_ID.DIZ, DESC.SDI
  44.     or DESC.SDN description into the file base description.  If the file
  45.     does not contain a description, you can search text files, capture
  46.     logs and even other BBS lists for a matching description to insert.
  47.  
  48.     You can set UpCheck to send a message to the user if a file should
  49.     fail, as well as the option to send yourself a receipt of the failure.
  50.  
  51.     If you are using RemoteAccess 2.x, then you can also send online
  52.     messages to the user to detail why a file failed while they're still
  53.     online the system.
  54.  
  55.     UpCheck comes with a program called UpUtils.   This program can
  56.     perform such database features as creating duplicate file signatures
  57.     from your existing collection of files, insert the descriptions of
  58.     files into your file database, quickly comment all of your ZIP files
  59.     in your current hard drive collection, in order to bring them all up
  60.     to date.  UpUtils can also set and return errorlevels depending on
  61.     the type of archive is being processed.
  62.  
  63.     ...in short, UpCheck does what all upload scanners do, and then adds
  64.     features not found in any other scanners.  It combines many features
  65.     that are found in numerous other third party applications - all into
  66.     one extremely inexpensive and powerful package.
  67.  
  68.  
  69. ╓───────────────────────────────────────────────────────────────────────────╖
  70. ║ UpSetup - Configuration program                                           ║
  71. ╙───────────────────────────────────────────────────────────────────────────╜
  72.  
  73.     UpCheck is very easy to install.
  74.  
  75.       1) First, unpack the contents of the archive into a directory
  76.       2) Run the UPSETUP program
  77.  
  78.     Remember that the UPCHECK.CFG file that is created by UpSetup should
  79.     always be in the same directory as the *.EXE files.   Also, the file
  80.     UPCHECK.PAC must also be in the same directory as these above files.
  81.  
  82.     The database  files that you  setup in  UPSETUP do not need to be in
  83.     any particular directory,  but to keep things simple you may want to
  84.     specify that they be created in the same directory.
  85.  
  86.     To save space, and your time, we have installed a comprehensive
  87.     online help system with UpCheck that you can activate from the setup
  88.     program by pressing F1.
  89.  
  90.     If you wish to create a text file from this help file, rather than
  91.     viewing it as you go, you can run HELP2DOC.EXE which will create
  92.     a readable documentation file detailing each option.
  93.  
  94.  
  95. ╓───────────────────────────────────────────────────────────────────────────╖
  96. ║ UpCheck - Upload scanning program                                         ║
  97. ╙───────────────────────────────────────────────────────────────────────────╜
  98.  
  99.     UpCheck, the executable itself, is the actual scanning program for
  100.     when a user uploads a file.  It is run from your bulletin board in
  101.     a numerous number of ways.  If the following setups do not work for
  102.     your system,  I would suggest that you consult your BBS software
  103.     documentation for info on installation of an upload scanner.
  104.  
  105.     Please remember that when running UpCheck you should have about 400
  106.     to 450k conventional memory available to call the external programs
  107.     for decompression, recompression and scanning.  UpCheck itself only
  108.     takes about 3k when calling these programs, but some of them require
  109.     a lot of memory themselves, so to save problems, it's best to make
  110.     sure you have a lot of memory available.
  111.  
  112.  
  113.     Running UpCheck
  114.     ──────────────────────────────────────────────────────────────────
  115.  
  116.      UPCHECK [dropfile [/I:hex,irq,locked]] <archive> [node] [options]
  117.  
  118.        <> = Required parameters
  119.        [] = Optional parameters
  120.  
  121.        [dropfile]   Full path and filename of EXITINFO.BBS, DORINFOx.DEF
  122.                     or DOOR.SYS.  If no dropfile is specified, then it
  123.                     will run in local mode without any remote display.
  124.  
  125.        [/I:hex..]   Use internal communications routines with the specified
  126.                     information instead of the fossil driver.  For example
  127.                     to not use the fossil driver, but use the internal com
  128.                     routines on COM2 (2f8), IRQ5 and with a locked baud rate
  129.                     of 57600, use /I:2F8,5,57600
  130.  
  131.                     ** IMPORTANT NOTE **
  132.  
  133.                     If you are using the internal communication routines,
  134.                     then UpCheck can not take advantage of it's swapping
  135.                     routines, and if you require more memory to run the
  136.                     scanner and extractors, you will need to use a program
  137.                     called "SHROOM.COM" (freqable using "SHROOM" from me
  138.                     at 1:2401/305)  Another solution might be temporairily
  139.                     installing a fossil driver before UpCheck is run and
  140.                     unloading it afterwards.
  141.  
  142.        <archive>    The archive filename (or wildcard search) to process.
  143.  
  144.        [node]       Define the current node.  This is mainly important
  145.                     for logging purposes.  Also, if you are using the
  146.                     DOOR.SYS file you never need to declare the node number.
  147.  
  148.        [options]    /NOViruscheck - Disable virus checking
  149.                     /NOAgecheck   - Disable file age checking
  150.                     /NODupecheck  - Disable duplicate file checking
  151.  
  152.                                                                                       [node]       Optionally override the node number
  153.     ═══ Running under RemoteAccess 2.x
  154.  
  155.          When running under RemoteAccess, the line that you should enter
  156.          in the...  "Options -> Files -> Upload scan" ...field should look
  157.          something like this:
  158.  
  159.              C:\UPCHECK\UPCHECK.EXE \RA\EXITINFO.BBS @ *N *M
  160.  
  161.          Or if you are running a multinode system:
  162.  
  163.              C:\UPCHECK\UPCHECK.EXE \RA\NODE*N\EXITINFO.BBS @ *N *M
  164.  
  165.          Recall from your RemoteAccess documentation that the *N is replaced
  166.          with the node number and the @ is replaced with the path/name of
  167.          the uploaded file, and that the *M means to use the MemorySwap
  168.          function of RemoteAccess.
  169.  
  170.          Here's an example below...
  171.  
  172.          ═════════════════════════════════════════════════════════════════
  173.          Scan online  Yes
  174.          Failed scan  /move to 58
  175.          Scan utility \RA\DOORS\UPCHECK\UPCHECK.EXE EXITINFO.BBS @ *N *M
  176.          ═════════════════════════════════════════════════════════════════
  177.  
  178.          UpCheck doesn't care  about the Failed Scan action, as RemoteAccess
  179.          will handle it when it gets the Pass or Fail sign from UpCheck.
  180.          You might however, want to either delete it or move it to another
  181.          directory,  as otherwise it will still be available for users.
  182.  
  183.          UpCheck doesn't care about the Scan Online either. If the dropfile
  184.          is missing, it will assume that there is no user online and will
  185.          surpress any output to the modem.  Note though, that if a dropfile
  186.          cannot be found, UpCheck can't figure out who is uploading the
  187.          file, therefore will not send mail to anyone should a file fail.
  188.  
  189.          Also remember to turn on upload scanning in the area(s) that you
  190.          permit uploads.
  191.  
  192.          You might also want to change the language prompt # 637 from
  193.          "Failed Virus Scan" to "Failed" as there are many reasons a file
  194.          can fail.
  195.  
  196.     ═══ Running under TriBBS
  197.  
  198.          When running under TriBBS, turn the "Scan Uploads" to "NO" in the
  199.          setup.  TriBBS looks for a file called "UPLOAD.BAT"  file in its
  200.          node directory, and runs it if it exists.
  201.  
  202.          Therefore you should place a file called "UPLOAD.BAT" that looks
  203.          similar to this, in _EACH_ of your node directories.
  204.  
  205.          --- UPLOAD.BAT
  206.              @echo off
  207.              c:\upcheck\UPCHECK.EXE c:\tribbs\dorinfo1.def %1
  208.              if errorlevel 1 goto :fail
  209.              goto :end
  210.              :fail
  211.              rem *** actions to take on failed file ***
  212.              move %1 c:\badfiles
  213.              c:\upcheck\UPUTILS.EXE /E 1
  214.              :end
  215.  
  216.              ( Of course change the paths mentioned  )
  217.              ( here to paths that reflect your setup )
  218.  
  219.          If you are running more than one node, then copy the UPLOAD.BAT
  220.          to each node directory, and change the reference from node 1 to the
  221.          other nodes, for example: c:\tribbs to show as c:\tribbs2, etc.
  222.  
  223.          It seems that some TriBBS users have had a problem when using
  224.          the DOOR.SYS dropfile when scanning, therefore I would suggest
  225.          using the DORINFOx.DEF file if you have any problems.
  226.  
  227.     ═══ Running under SuperBBS 1.17+
  228.  
  229.          When running under SuperBBS, you should set the CONFIG.EXE ══
  230.          Paths ══ Virus Scanner to look something like this:
  231.  
  232.              C:\UTIL\UPCHECK.EXE C:\SBBS\DORINFO1.DEF %1
  233.  
  234.              ( Where %1 is the drive\path\filename.ext )
  235.  
  236.          Also CONFIG.EXE ══ Paths ══ Virus Check, should be set to "Yes".
  237.          If you require or have a more complex setup, you can either edit
  238.          your BBS.BAT file, or call a batch file for scanning, instead the
  239.          actual EXE file. Remember that UpUtils can be utilized to change
  240.          and report errorlevels as needed.
  241.  
  242.     ═══ Running under PCBoard
  243.  
  244.          Running under PCBoard is a little different then  for most systems.
  245.          You will need a batch file that looks something like this:
  246.  
  247.          --- PCBTEST.BAT
  248.              @echo off
  249.              if not %2 == UPLOAD goto :not_upload
  250.          δ   TYPE %3 >> c:\pcb\main\public
  251.              DEL %3
  252.              IF exists pcbfail.txt DEL pcbfail.txt
  253.              c:\upcheck\UPCHECK.EXE door.sys %1
  254.              IF errorlevel 1 ECHO. > pcbfail.txt
  255.              goto :end
  256.  
  257.              REM --------------------------------------------
  258.              REM This is the part for non-upload testing...
  259.              REM Used from the original PCBTEST.BAT
  260.              REM --------------------------------------------
  261.              :not_upload
  262.              testfile %1 arc zip
  263.              if errorlevel == 98  goto end
  264.              if errorlevel == 2   goto zip
  265.              if errorlevel == 1   goto arc
  266.              goto end
  267.  
  268.              :zip
  269.              echo ■ Testing ZIP file integrity
  270.              pkunzip -t %1 > pcbfail.txt
  271.              if errorlevel == 1 goto end
  272.              del pcbfail.txt
  273.              goto end
  274.  
  275.              :arc
  276.              echo ■ Testing ARC file integrity
  277.              pkxarc -t %1 > pcbfail.txt
  278.              if errorlevel == 1 goto end
  279.              del pcbfail.txt
  280.              goto end
  281.  
  282.              :end
  283.  
  284.          δ   In the above example the c:\pcb\mail\public
  285.              is the name of your upload directory.
  286.  
  287.  
  288.     ═══ Running under other BBS software
  289.  
  290.          UpCheck can run under practically any type of BBS software with
  291.          few modifications or troubles.  The key things to remember are
  292.          that you should turn on the Upload Scanning feature of your
  293.          software, and for the file name of the Upload Scanning Program,
  294.          just insert UPCHECK.EXE with the appropriate parameters as
  295.          mentioned above.
  296.  
  297.  
  298. ╓───────────────────────────────────────────────────────────────────────────╖
  299. ║ UpCheck - The log file                                                    ║
  300. ╙───────────────────────────────────────────────────────────────────────────╜
  301.  
  302.     The log file contains information about who uploaded what, and what
  303.     happened to the file.  It has four possible entry types...
  304.  
  305.     1) User: This is the user's name
  306.     2) File: This is the file that was processed
  307.     3) Code: This is a code to explain an error if one occurred
  308.     4) Stat: This is the status of the file
  309.  
  310.     Below is  a table that  gives a reference  to many  of the possible
  311.     values that "Code" may return.
  312.  
  313.        ═════╤════════════════════════════════════════════════════════
  314.        Code │ Section = Program return codes
  315.        ═════╪════════════════════════════════════════════════════════
  316.         0-x │ Every program has its own return code setup, consult
  317.             │ its documentation regarding the (x) return code
  318.  
  319.        ═════╤════════════════════════════════════════════════════════
  320.        Code │ Section = Swapping routines
  321.        ═════╪════════════════════════════════════════════════════════
  322.         1-1 │ No space for swapping
  323.         1-2 │ Program is too low in memory
  324.         4-0 │ Error allocating environment
  325.         5-0 │ Error calling swap
  326.         5-1 │ Could not return from swap
  327.         5-2 │ Could not swap out
  328.         6-x │ Error caused during redirection
  329.  
  330.        ═════╤════════════════════════════════════════════════════════
  331.        Code │ Section = Program being called
  332.        ═════╪════════════════════════════════════════════════════════
  333.         2-0 │ Not found
  334.         2-1 │ Invalid drive
  335.         2-2 │ Invalid path
  336.         2-3 │ Invalid name
  337.         2-4 │ Invalid drive letter
  338.         2-5 │ Path too long
  339.         2-6 │ Drive not ready
  340.  
  341.        ═════╤════════════════════════════════════════════════════════
  342.        Code │ Section = Dos error codes
  343.        ═════╪════════════════════════════════════════════════════════
  344.         3-2 │ File not found
  345.         3-3 │ Path not found
  346.         3-5 │ Access denied
  347.         3-6 │ Invalid handle
  348.         3-8 │ Not enough memory
  349.  
  350.  
  351. ╓───────────────────────────────────────────────────────────────────────────╖
  352. ║ UpUtils - System Utilities                                                ║
  353. ╙───────────────────────────────────────────────────────────────────────────╜
  354.  
  355.     UpUtils is a supplementary program that is designed to simplify the
  356.     job of creating duplicate  databases and  making sure  that all the
  357.     file  descriptions are correct,  as  well as  add support for third
  358.     party utilities.  Wildcards are valid for UpUtils.
  359.  
  360.  
  361.     Running UpUtils
  362.     ──────────────────────────────────────────────────────────────────
  363.  
  364.     ═══ Command line parameters
  365.  
  366.          /A = Add the files signature into the bad files listing. This
  367.               is good for files that stay the same except their name,
  368.               like randomly named BBS ads.
  369.  
  370.          /I = Enable the insertion of descriptions that are included
  371.               inside some of the files.   This allows you to quickly
  372.               put your descriptions into the data base.
  373.  
  374.          /Y = Yank descriptions from text files.  This switch will extract
  375.               descriptions from other BBS lists, captured logs, FILES.1
  376.               type files, in just about any format.
  377.  
  378.               If the file does not contain a FILE_ID.DIZ, DESC.SDI or
  379.               DESC.SDN, then UpUtils will attempt to locate the files in
  380.               the 'Description Files', that are set in UpSetup.  If found,
  381.               it will extract the description from the text files and insert
  382.               it into the FDB
  383.  
  384.               The "/I"  switch must be on for the "/Y" switch to operate.
  385.  
  386.          /D = Enable duplicate checking & building.  This allows you to
  387.               build a dupe list of all your files that are presently
  388.               on your system.
  389.  
  390.          /K = Kill duplicate files.  This switch will cause all the files
  391.               that are checked and duplicates to be deleted.
  392.  
  393.               **USE THIS WITH EXTREME CAUTION**
  394.  
  395.               You could lose all your files if you do not use this one
  396.               properly.   The "/D" switch must be on for the "/K" switch
  397.               to operate.
  398.  
  399.          /P = This is the same as the /K switch but will prompt you for a
  400.               decision before deleting the file.  The "/D" switch must be
  401.               on for the "/P" to operate.
  402.  
  403.          /S = Scan subdirectories.   This switch is useful when doing all
  404.               your files as it allows the program to search the specified
  405.               directory and all of its lower subdirectories also.
  406.  
  407.          /Q = Query the database.  This switch will return the current
  408.               statistics of the database holding the information on the
  409.               number of files processed, failed and passed, etc.
  410.  
  411.          /C = Comment ZIP files.  This switch will comment the ZIP files
  412.               it comes in contact with,  with the ZIP comment file as
  413.               specified in UpSetup.
  414.  
  415.          /Z = Purge the duplicate files database.  This command will remove
  416.               signatures of files that are smaller than the 'minimum size to
  417.               store' setting.  The benefits of a smaller database is mainly
  418.               speed while checking for any duplicate files.  The drawback
  419.               is the chance of smaller files passing the dupe check when
  420.               they are duplicates.
  421.  
  422.          /E = Returns an errorlevel as specified.  This is only good when
  423.               creating an advanced batch file setup.   Refer to the next
  424.               section for more info.
  425.  
  426.          /R = Returns an errorlevel associated to the type of file processed.
  427.               Again, this is for the advanced batch file setups.
  428.  
  429.          The UpUtils program also requires a file specification for files
  430.          to process.   Wild cards are valid.  For example, if you want
  431.          to process all ZIP files, you would put "*.ZIP" for your file
  432.          specification.
  433.  
  434.          Although UpCheck will handle multi-level embedded archives,
  435.          UpUtils only will seek into the original archive.  The reason for
  436.          this, is that any other way would make the building of your
  437.          database too incredibly time consuming, and that the first level
  438.          is usually more then enough for testing.
  439.  
  440.          If you require each file to be processed fully, use UpCheck in
  441.          local mode instead of UpUtils.
  442.  
  443.  
  444.     Sample batch files for automated tools
  445.     ──────────────────────────────────────────────────────────────────
  446.  
  447.     ═══ Batch Files
  448.  
  449.          Download a lot of files but hate uploading them locally or
  450.          running UpCheck in local mode?   Well with UpUtils,  you can
  451.          use a batch file like this...
  452.  
  453.          @echo off
  454.          MOVE \downloads\*.* \bbs\uploads
  455.          UPUTILS /i /d /c \bbs\uploads\*.*
  456.  
  457.          It's a fast way to add the signatures to the duplicate base,
  458.          comment your ZIP files and insert the FILE_ID.DIZ.
  459.  
  460.          If you need to perform full scanning, and to add your BBS file
  461.          to the archive, then use a batch file like this...
  462.  
  463.          @echo off
  464.          move \downloads\*.* \bbs\uploads
  465.          UPCHECK \bbs\uploads\*.*
  466.  
  467.          This will perform the full scanning on the files and add the
  468.          archive comment, archive file, recompress, delete all the
  469.          unwanted files, scan, etc.. and add the FILE_ID.DIZ to the
  470.          filebase description.  Remember that for both of these batch
  471.          files, it's a good idea that the "\bbs\uploads" directory be
  472.          empty before running this, as otherwise, it will process the
  473.          files that had already been processed prior to running the batch
  474.          file.   Also note, that you should replace the "\bbs\uploads"
  475.          and "\downloads" with the appropriate paths for your own system.
  476.  
  477.  
  478. ╓───────────────────────────────────────────────────────────────────────────╖
  479. ║ Advanced User Tools                                                       ║
  480. ╙───────────────────────────────────────────────────────────────────────────╜
  481.  
  482.    With the UpUtils utility you can build your own advanced batch file.
  483.    With a great batch file, you can make just about anything happen with
  484.    your archives.
  485.  
  486.    The two functions /REPORT and /ERRORLEVEL allow for some great ways
  487.    to handle certain conditions.
  488.  
  489.    The easiest way to show how  you can use these is to look at the file
  490.    ADVANCED.BAT that is included in this archive.
  491.  
  492.    Remember that UpCheck does not require that you make such a batch
  493.    file system and will run just fine in 99.99% of all situations. These
  494.    functions are to provide additional ways for you to implement third
  495.    party utilities.
  496.  
  497.  
  498. ╓───────────────────────────────────────────────────────────────────────────╖
  499. ║ Scanning in text for descriptions                                         ║
  500. ╙───────────────────────────────────────────────────────────────────────────╜
  501.  
  502.     With UpUtils, you can retrieve descriptions for files that do not
  503.     have a FILE_ID.DIZ, DESC.SDI or DESC.SDN in them.   This is done by
  504.     setting up some "Description files" in the UpSetup program, and then
  505.     using the "/YANK" switch of UpUtils (with the "/INSERT" switch also)
  506.     What UpUtils will do is scan through these "description files" and
  507.     search for a matching filename.  If one is found, it will grab the
  508.     description that is listed, and insert it into your filebase.  The
  509.     files can be almost any text format, as UpUtils will synchronize the
  510.     descriptions itself.  For example, if you called up a BBS, you could
  511.     turn on your 'capture' function of your terminal, then when you had
  512.     downloaded some files, you could use this capture file as a file to
  513.     search through in case the files didn't have a FILE_ID.DIZ type file
  514.     in them.  This is what you can do:
  515.  
  516.       1) Go into your terminal and start a capture file
  517.       2) Call a BBS and download some files, read mail, whatever
  518.       3) Repeat step 2 as many times as you wish
  519.       4) Exit the terminal
  520.       5) Run UpUtils with /INSERT /YANK /COMMENT  and /DUPE turned
  521.          on, in order to insert all the descriptions (yanked or
  522.          embedded), comment the ZIP files with your logo, and add
  523.          the files data into the duplicate database.
  524.  
  525.     With this you will never need to enter a description manually into
  526.     your file listings again!
  527.  
  528.     Another use for this might be if setting up a new BBS,  and you want
  529.     to add all the descriptions for the files you have.  Well, you could
  530.     download a couple BBS lists from other systems, and use those for
  531.     description files to be yanked from.   Also, if you ever lost your
  532.     descriptions, you could insert them back using your own BBS listing.
  533.  
  534.  
  535. ╓───────────────────────────────────────────────────────────────────────────╖
  536. ║ Running with TBAV                                                         ║
  537. ╙───────────────────────────────────────────────────────────────────────────╜
  538.  
  539.     UpCheck will run with any scanning system created now or in the
  540.     future.  UpCheck will handle multiple scanners, because it can call
  541.     any program you wish, including batch files.  Here's an example file
  542.     that will use McAfee's scanning system, and then ThunderByte after.
  543.  
  544.          @echo off
  545.          SCAN *.* /sub /nomem /nopause        (for McAfee Scan v1.x)
  546.          SCAN *.* /sub /nomem                 (for McAfee Scan v2.x)
  547.          if errorlevel 1 goto :end
  548.          if exist *.exe goto :next
  549.          if exist *.com goto :next
  550.          if exist *.sys goto :next
  551.          goto :end
  552.          :next
  553.          TBSCAN nb nm nh ba lo ll=0 ap ol ln=c:\upcheck\upcheck.log
  554.          :end
  555.  
  556.     To implement this,  select UpSetup ═ External Programs ═ Scanning and
  557.     replace the "SCAN.EXE etc" with  the name of the batch file you just
  558.     created.  Now your system is setup to work with TBAV and McAfee.
  559.  
  560.        Scanning Program:  SCAN.BAT
  561.  
  562.           (  Provided SCAN.BAT is in your system path, otherwise  )
  563.           (  include the full path to the batch file you created. )
  564.  
  565.     With the same principles, you can do any type of scanning,  or other
  566.     modifications on archives for that matter, by replacing the standard
  567.     "External Programs" with your own customized batch files.
  568.  
  569.  
  570. ╓───────────────────────────────────────────────────────────────────────────╖
  571. ║ Matchup files                                                             ║
  572. ╙───────────────────────────────────────────────────────────────────────────╜
  573.  
  574.     If you plan on receiving uploads into directories and having the file
  575.     listing for that directory stored in another directory, you will need
  576.     to use a matchup file.
  577.  
  578.     The structure of a matchup file is quite simple:
  579.  
  580.     Full_path_to_file_list,Directory_path_for_uploads
  581.  
  582.     For example, you could call your matchup file MATCHUP.CFG:
  583.  
  584.     C:\PCB\DIR1,C:\FILES\UPLOADS
  585.     C:\PCB\DIR2,C:\FILES\GAMES
  586.     C:\PCB\DIR3,C:\FILES\BBSDOORS
  587.  
  588.     Then you would tell UpCheck to use this matchup file in order to find
  589.     the correct file listing to update when uploads were received.
  590.  
  591.  
  592. ╓───────────────────────────────────────────────────────────────────────────╖
  593. ║ License and Disclaimer                                                    ║
  594. ╙───────────────────────────────────────────────────────────────────────────╜
  595.  
  596.     UpCheck is now free.
  597.  
  598.     By running any of the executable programs included, you agree that
  599.     Pete Rocca, nor any affiliates of Pete Rocca are responsible for
  600.     any damage ever experienced, however so created. If you cannot agree
  601.     to this, then your privilege to use any of these programs is revoked
  602.     and it becomes illegal for you to execute any programs included with
  603.     this documentation.
  604.  
  605.     It is illegal to edit, alter, hack, reverse engineer and / or modify
  606.     any components of the UpCheck archive in any manner.
  607.  
  608.     If dispute of any issues on legal grounds said above, then governing
  609.     law of Ontario, Canada will rule.
  610.  
  611.  
  612. ╓───────────────────────────────────────────────────────────────────────────╖
  613. ║ Registration                                                              ║
  614. ╙───────────────────────────────────────────────────────────────────────────╜
  615.  
  616.    Registration is now free, use the information in FREE-KEY.TXT to
  617.    activate the free registration.
  618.  
  619. ╓───────────────────────────────────────────────────────────────────────────╖
  620. ║ Support                                                                   ║
  621. ╙───────────────────────────────────────────────────────────────────────────╜
  622.  
  623.    There is no longer any author support for UpCheck since it is now a
  624.    freeware program.  You can still visit our website or get help from
  625.    your peers in the RA_UTIL or MCC_SUPPORT FidoNet echos as well.
  626.  
  627.    http://www.multiboard.com
  628.  
  629. ╓───────────────────────────────────────────────────────────────────────────╖
  630. ║ Common questions and answers                                              ║
  631. ╙───────────────────────────────────────────────────────────────────────────╜
  632.  
  633.     Q: Can I run it with TBAV and F-PROT?
  634.     A: Yes,  read the "Running with TBAV" section,  and simply adjust the
  635.        batch file as need.
  636.  
  637.     Q: My users don't get anything on their side when UpCheck is running?
  638.     A: Make sure that the dropfile (DOOR.SYS, DORINFOx.DEF, etc) is where
  639.        you have specified on the command line. If the dropfile is missing
  640.        UpCheck will run in local mode only.
  641.  
  642.     Q: It seems to lockup during zipping or unzipping.
  643.     A: Try adding "-)"  (without the quotes)  to the end  of the .ZIP de/
  644.        recompression lines. This disables the DPMI option of ZIP which is
  645.        not fully compatible with some DPMI servers.
  646.  
  647.     Q: Do I have to put the files in my path?
  648.     A: No,  nor do you need to set any environment variables. If you want
  649.        to be able to  run these files  from anywhere on your system,  you
  650.        might want  to make some  batch files that  are in your path, that
  651.        would simply look like this:
  652.  
  653.        --- UPCHECK.BAT
  654.        @echo off
  655.        c:\upcheck\UPCHECK.EXE %1 %2 %3
  656.  
  657.        --- UPUTILS.BAT
  658.        @echo off
  659.        c:\upcheck\UPUTILS.EXE %1 %2 %3 %4 %5 %6 %7 %8 %9
  660.  
  661.     Q: Will UpCheck work properly on multinode systems if someone else is
  662.        uploading, or browsing the file areas?
  663.     A: Absolutely.  UpCheck is able to fully scan files, check duplicates
  664.        update the filebase and  post messages when  other nodes are using
  665.        the same files.  UpCheck is fully SHARE/Network locking aware.
  666.  
  667.     Q: I noticed that  with 2400 baud callers,  sometimes the file starts
  668.        scanning before they have the updated screen?
  669.     A: Yes, UpCheck will dump the screen to the modem,  and then start to
  670.        perform its tasks.   This way,  the user has less time to wait for
  671.        their upload to be processed.
  672.  
  673.     Q: Can I disable virus scanning?
  674.     A: Yes, specify the scanning program as "OFF" (without the quotes)
  675.  
  676.     Q: Does UpCheck work with OS/2?
  677.     A: Yes.  This program has not had any reported bugs when running with
  678.        OS/2 2.0 through 3.0, as well as WinOS/2, DESQview 2.40 through 2.63,
  679.        DESQview/X 1.2 through 2.0 and MS-DOS 3.0 through 7.0.  It also
  680.        works under Windows 3.x, WindowsNT and Windows95.
  681.  
  682.     Q: I see this wierd  blue square  flashing in the top right corner of
  683.        my screen.
  684.     A: This is an indicator to you  that file access has been denied from
  685.        UpCheck or UpUtils for more than a half a second. It will continue
  686.        for about 30 seconds or until the files are made  available to it.
  687.        This is to let you know the current situation, so you do not think
  688.        that your system is 'frozen' or 'hung'.  The square  will never be
  689.        displayed to a remote caller.
  690.  
  691.     Q: The file listings are not being updated!
  692.     A: There are a number of reasons this might be happening.
  693.          The most common are...
  694.          1) scanning files in a directory that is not defined in either
  695.             the FILES.RA (RemoteAccess 2.x) or in the matchup file for
  696.             non-RemoteAccess 2.x users.
  697.          2) the filebase was locked for more that 30 seconds
  698.          3) the filelist name in the matchup file is incorrect
  699.  
  700.  
  701. ╓───────────────────────────────────────────────────────────────────────────╖
  702. ║ Errors                                                                    ║
  703. ╙───────────────────────────────────────────────────────────────────────────╜
  704.  
  705.    If you ever get a runtime error, chances are pretty good that you have
  706.    incorrectly specified a path or file name, or you that the UPCHECK.CFG
  707.    or UPCHECK.DAT file is corrupted.
  708.  
  709.    In any case, if you ever get a runtime error, the only thing that will
  710.    most likely happen is that the  file will report failed.  Any runtime
  711.    errors will NOT cause your system to 'hang'.
  712.  
  713.    Any logical errors or runtime errors that you cannot seem to resolve
  714.    should be reported to 1:2401/305 for my evaluation, please include the
  715.    error number and location, the look of the screen and the current task
  716.    that the program was under and I will get back to you with a solution.
  717.  
  718.         Example : Runtime error 103 at 05C3:3029
  719.                                   \         \
  720.                                    Number    Location
  721.  
  722.  
  723.    Other neat stuff:
  724.  
  725.    UpCheck avoids a large number of problems that other scanners seemed
  726.    to have over looked.  The classic one is this:
  727.  
  728.       a) a file called TEST.ARJ gets uploaded and rearchived to ZIP
  729.          format so now a file called TEST.ZIP exists
  730.  
  731.       b) a different program called TEST.LZH gets uploaded and
  732.          rearchived to  ZIP, the BBS allowed the upload because the
  733.          file TEST.LZH did not exist, but the scanner failed to
  734.          realize that another program already existed in the same
  735.          directory with the same name.  The scanner would either
  736.          delete the first file, or add all of TEST.LZH's files into
  737.          the first file. Yuck!
  738.  
  739.    UpCheck would have renamed the second file TEST.ZI0 and updated the
  740.    filebase accordingly. UpCheck will continue renaming from ZI0 to ZI9
  741.    to ZIA to ZIZ as files are duplicated. (Although the rarity of any of
  742.    this happening is so far fetched, it shows the detail and concern
  743.    that UpCheck exhibits)
  744.  
  745.    Many other scanners will also not update the filebase with the new
  746.    size or type of the file once rearchived (and/or the garbage killed)
  747.    but UpCheck will always update the base.
  748.  
  749.    Also, many scanners either abort or 'freeze' the system if a caller
  750.    hangs up during scanning.... not UpCheck.
  751.  
  752.    Also, if the file doesn't exist in the filebase, some scanners will
  753.    not update it with the added information, or the FILE_ID.DIZ files.
  754.  
  755.  
  756. ╓───────────────────────────────────────────────────────────────────────────╖
  757. ║ Acknowledgments                                                           ║
  758. ╙───────────────────────────────────────────────────────────────────────────╜
  759.  
  760.     Requires at least Dos 3.3 and  about 450k free conventional memory.
  761.     (Can't do much about the memory problem, only 3k of that is mine,
  762.     the rest you can blame on McAfee and the author of SQZ.) SHARE.EXE
  763.     must also be loaded for Dos systems.
  764.  
  765.     The JAM message base format is used in UpCheck and  this is the JAM
  766.     license header...  "JAM(mbp) - Copyright 1993 Joaquim Homrighausen,
  767.     Andrew Milner, Mats Birch, Mats Wallin. ALL RIGHTS RESERVED."   The
  768.     RemoteAccess filebase format, RemoteAccess and RA are (C) Copyright
  769.     Andrew Milner and Wantree Development, 1993.   All rights reserved.
  770.     The TriBBS  message base format is Copyright 1993 Mark D.  Goodwin.
  771.     SuperBBS Bulletin  Board Software is Copyright (C) 1990-1993, Risto
  772.     Virkkala and Aki Antman.  The PCBoard software is Copyright (C)1993
  773.     by Clark Development Company, Inc.
  774.  
  775.     PKZIP/UNZIP,PKARC/PKXARC, Copyright PKWARE; ARJ, Copyright Robert K
  776.     Jung; LZH/LHA, Copyright Haruyasu Yoshizaki; PAK,  Copyright NoGate
  777.     Consulting; UC2, Copyright Ad Infinitum Programs;  SQZ, Copyright J
  778.     I. Hammarberg;  SCAN, Copyright by McAfee Associates;  TBSCAN/TBAV,
  779.     Copyright Thunderbyte B.V; X00, Copyright Ray Gwinn; BNU, Copyright
  780.     David Nugent & Unique Computing; DESQview, Copyright by Quarterdeck
  781.     Software;  MS-DOS, MS-Windows,  Copyright by Microsoft Corporation;
  782.     OS/2, Copyright International Business Machines Corporation. Thanks
  783.     to the  public domain swapping  utilities that required very little
  784.     in the way of tweaking, by Thomas Wagner. GIF(tm) is a trademark of
  785.     CompuServe. JPG is maintained by an ISO WorkGroup and ANSI.
  786.  
  787.     Also, a BIG THANKS, to my wife Laurie,  who hates me being on 'this
  788.     damn machine', but still finds the way to support me.  Thank you.
  789.  
  790.  
  791.                            * Documentation End *
  792.